Layout: Tweak documentation blurb
authorDaniel Boles <dboles@src.gnome.org>
Thu, 3 Aug 2017 09:13:52 +0000 (10:13 +0100)
committerDaniel Boles <dboles@src.gnome.org>
Thu, 3 Aug 2017 09:19:13 +0000 (10:19 +0100)
Being addable to a ScrolledWindow is not interesting; now that SW
auto-adds a Viewport if needed, so can DrawingArea and any other widget.

Mention GtkFixed in case the reader just wants that bit of functionality

gtk/gtklayout.c

index c4e46ae49379fcb3e8b34f0b2473b38b5885e01e..d89cc9f587bf1d627f10424bc44174ecdb3e08f2 100644 (file)
  * @Short_description: Infinite scrollable area containing child widgets
  *   and/or custom drawing
  * @Title: GtkLayout
- * @See_also: #GtkDrawingArea, #GtkScrolledWindow
+ * @See_also: #GtkDrawingArea, #GtkFixed
  *
- * #GtkLayout is similar to #GtkDrawingArea in that it’s a “blank slate”
- * and doesn’t do anything but paint a blank background by default. It's
- * different in that it supports scrolling natively (you can add it to a
- * #GtkScrolledWindow), and it can contain child widgets, since it’s a
- * #GtkContainer. However if you’re just going to draw, a #GtkDrawingArea
- * is a better choice since it has lower overhead.
+ * #GtkLayout is similar to #GtkDrawingArea in that it’s a “blank slate” and
+ * doesn’t do anything except paint a blank background by default. It’s
+ * different in that it supports scrolling natively due to implementing
+ * #GtkScrollable, and can contain child widgets since it’s a #GtkContainer.
+ *
+ * If you just want to draw, a #GtkDrawingArea is a better choice since it has
+ * lower overhead. If you just need to position child widgets at specific
+ * points, then #GtkFixed provides that functionality on its own.
  */